<!DOCTYPE html><html lang="zh-CN"><head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width">
  <title>&#x8BBE;&#x7F6E;&#x8BED;&#x8A00;&#x73AF;&#x5883; (&#x5168;&#x5C40;) | Moment.js &#x6587;&#x6863;</title>
  <link rel="stylesheet" href="static/css/style.css">
  <link rel="shortcut icon" href="http://momentjs.cn/static/img/moment-favicon.png">
  <link rel="stylesheet" href="static/css/atom-one-light.min.css">
</head>
<body class="is-moment">
  <div class="hero hero-oneline">
    <div class="hero-centered">
      <h1>&#x8BBE;&#x7F6E;&#x8BED;&#x8A00;&#x73AF;&#x5883; (&#x5168;&#x5C40;)</h1>
    </div>
  </div>
  <div id="api-section-__FILENAME__">
    <div id="content" class="clearfix">
  
      <div id="column1" data-id="__ID__" class="interior">
        <header>
          <!-- <h1>设置语言环境 (全局)</h1> -->
          <div id="gtoc">
            <ul>
              <!-- <li>v</li> -->
              <li>
                <a href="index.html#/i18n/changing-locale/" name="toc">&#x8FD4;&#x56DE;&#x4E0A;&#x5C42;&#x6587;&#x6863;</a>
              </li>
              <li style="border: none;">
                <a href="javascript:window.open('https://github.com/momentjscn/moment-docs-cn/edit/master/moment/06-i18n/01-changing-locale.md');" rel="nofollow" target="_blank">&#x63D0;&#x4EA4;&#x4FEE;&#x6539;</a>
              </li>
              <!-- <li>
                <a href="/search__SEARCH_PARAM__" name="toc">搜索</a>
              </li> -->
            </ul>
          </div>
          <hr>
        </header>

        <div id="biz_item"></div>
  
        <div id="apicontent">
          <div id="content_left">
							<div class="docs-method-signature">
								<pre><code class="language-js">// &#x4ECE; 2.8.1 &#x5F00;&#x59CB;
moment.locale(String);
moment.locale(String[]);
moment.locale(String, Object);

// &#x5E9F;&#x5F03;&#x4E8E; 2.8.1
moment.lang(String);
moment.lang(String[]);
moment.lang(String, Object);
</code></pre>

							</div>
<p>&#x9ED8;&#x8BA4;&#x60C5;&#x51B5;&#x4E0B;&#xFF0C;Moment.js &#x968F;&#x9644;&#x82F1;&#x8BED;&#xFF08;&#x7F8E;&#x56FD;&#xFF09;&#x8BED;&#x8A00;&#x73AF;&#x5883;&#x5B57;&#x7B26;&#x4E32;&#x3002;
&#x5982;&#x679C;&#x9700;&#x8981;&#x5176;&#x4ED6;&#x8BED;&#x8A00;&#x73AF;&#x5883;&#xFF0C;&#x5219;&#x53EF;&#x4EE5;&#x5C06;&#x5B83;&#x4EEC;&#x52A0;&#x8F7D;&#x5230; Moment.js &#x4E2D;&#x4EE5;&#x4F9B;&#x968F;&#x540E;&#x4F7F;&#x7528;&#x3002;</p>
<p>&#x8981;&#x52A0;&#x8F7D;&#x8BED;&#x8A00;&#x73AF;&#x5883;&#xFF0C;&#x5219;&#x5C06;&#x952E;&#x548C;&#x5B57;&#x7B26;&#x4E32;&#x503C;&#x4F20;&#x7ED9; <code>moment.locale</code>&#x3002;</p>
<p>&#x53EF;&#x4EE5;&#x5728;<a href="javascript:window.open('http://nodejs.cn/s/LMMxW3');" target="_blank" rel="nofollow">&#x81EA;&#x5B9A;&#x4E49;</a>&#x7AE0;&#x8282;&#x4E2D;&#x627E;&#x5230;&#x6709;&#x5173;&#x8BED;&#x8A00;&#x73AF;&#x5883;&#x5305;&#x7684;&#x5404;&#x4E2A;&#x90E8;&#x5206;&#x7684;&#x66F4;&#x591A;&#x8BE6;&#x7EC6;&#x4FE1;&#x606F;&#x3002;</p>
<pre><code class="language-javascript">moment.locale(&apos;fr&apos;, {
    months : &apos;janvier_f&#xE9;vrier_mars_avril_mai_juin_juillet_ao&#xFB;t_septembre_octobre_novembre_d&#xE9;cembre&apos;.split(&apos;_&apos;),
    monthsShort : &apos;janv._f&#xE9;vr._mars_avr._mai_juin_juil._ao&#xFB;t_sept._oct._nov._d&#xE9;c.&apos;.split(&apos;_&apos;),
    monthsParseExact : true,
    weekdays : &apos;dimanche_lundi_mardi_mercredi_jeudi_vendredi_samedi&apos;.split(&apos;_&apos;),
    weekdaysShort : &apos;dim._lun._mar._mer._jeu._ven._sam.&apos;.split(&apos;_&apos;),
    weekdaysMin : &apos;Di_Lu_Ma_Me_Je_Ve_Sa&apos;.split(&apos;_&apos;),
    weekdaysParseExact : true,
    longDateFormat : {
        LT : &apos;HH:mm&apos;,
        LTS : &apos;HH:mm:ss&apos;,
        L : &apos;DD/MM/YYYY&apos;,
        LL : &apos;D MMMM YYYY&apos;,
        LLL : &apos;D MMMM YYYY HH:mm&apos;,
        LLLL : &apos;dddd D MMMM YYYY HH:mm&apos;
    },
    calendar : {
        sameDay : &apos;[Aujourd&#x2019;hui &#xE0;] LT&apos;,
        nextDay : &apos;[Demain &#xE0;] LT&apos;,
        nextWeek : &apos;dddd [&#xE0;] LT&apos;,
        lastDay : &apos;[Hier &#xE0;] LT&apos;,
        lastWeek : &apos;dddd [dernier &#xE0;] LT&apos;,
        sameElse : &apos;L&apos;
    },
    relativeTime : {
        future : &apos;dans %s&apos;,
        past : &apos;il y a %s&apos;,
        s : &apos;quelques secondes&apos;,
        m : &apos;une minute&apos;,
        mm : &apos;%d minutes&apos;,
        h : &apos;une heure&apos;,
        hh : &apos;%d heures&apos;,
        d : &apos;un jour&apos;,
        dd : &apos;%d jours&apos;,
        M : &apos;un mois&apos;,
        MM : &apos;%d mois&apos;,
        y : &apos;un an&apos;,
        yy : &apos;%d ans&apos;
    },
    dayOfMonthOrdinalParse : /\d{1,2}(er|e)/,
    ordinal : function (number) {
        return number + (number === 1 ? &apos;er&apos; : &apos;e&apos;);
    },
    meridiemParse : /PD|MD/,
    isPM : function (input) {
        return input.charAt(0) === &apos;M&apos;;
    },
    // &#x5982;&#x679C;&#x5B50;&#x5348;&#x7EBF;&#x5355;&#x4F4D;&#x672A;&#x5728;12&#x5DE6;&#x53F3;&#x5206;&#x5F00;&#xFF0C;&#x5219;&#x5B9E;&#x73B0;&#x6B64;&#x51FD;&#x6570;&#xFF08;&#x4EE5; locale/id.js &#x4E3A;&#x4F8B;&#xFF09;&#x3002;
    // meridiemHour : function (hour, meridiem) {
    //     return /* 0-23 &#x5C0F;&#x65F6;&#xFF0C;&#x7ED9;&#x5B9A;&#x7684;&#x5B50;&#x5348;&#x7EBF;&#x4EE4;&#x724C;&#x548C; 1-12&#x5C0F;&#x65F6; */ ;
    // },
    meridiem : function (hours, minutes, isLower) {
        return hours &lt; 12 ? &apos;PD&apos; : &apos;MD&apos;;
    },
    week : {
        dow : 1, // &#x661F;&#x671F;&#x4E00;&#x662F;&#x4E00;&#x5468;&#x7684;&#x7B2C;&#x4E00;&#x5929;&#x3002;
        doy : 4  // &#x7528;&#x4E8E;&#x5224;&#x65AD;&#x4E00;&#x5E74;&#x4E2D;&#x7684;&#x7B2C;&#x4E00;&#x5468;&#x3002;
    }
});
</code></pre>
<p>&#x6709;&#x5173; <code>week.dow</code> &#x548C; <code>week.doy</code> &#x7684;&#x8BE6;&#x7EC6;&#x4FE1;&#x606F;&#x53EF;&#x4EE5;&#x5728;<a href="javascript:window.open('http://nodejs.cn/s/4R8WBy');" target="_blank" rel="nofollow">&#x81EA;&#x5B9A;&#x4E49;</a>&#x7AE0;&#x8282;&#x4E2D;&#x627E;&#x5230;&#x3002;</p>
<p>&#x52A0;&#x8F7D;&#x8BED;&#x8A00;&#x73AF;&#x5883;&#x4E4B;&#x540E;&#xFF0C;&#x5219;&#x5B83;&#x4F1A;&#x6210;&#x4E3A;&#x6D3B;&#x52A8;&#x7684;&#x8BED;&#x8A00;&#x73AF;&#x5883;&#x3002;
&#x8981;&#x66F4;&#x6539;&#x6D3B;&#x52A8;&#x7684;&#x8BED;&#x8A00;&#x73AF;&#x5883;&#xFF0C;&#x53EA;&#x9700;&#x4F7F;&#x7528;&#x5DF2;&#x52A0;&#x8F7D;&#x7684;&#x8BED;&#x8A00;&#x73AF;&#x5883;&#x7684;&#x952E;&#x8C03;&#x7528; <code>moment.locale</code>&#x3002;</p>
<pre><code class="language-javascript">moment.locale(&apos;fr&apos;);
moment(1316116057189).fromNow(); // il y a une heure
moment.locale(&apos;en&apos;);
moment(1316116057189).fromNow(); // an hour ago
</code></pre>
<p>&#x4ECE; <strong>2.21.0</strong> &#x5F00;&#x59CB;&#xFF0C;&#x5982;&#x679C;&#x8BED;&#x8A00;&#x73AF;&#x5883;&#x4E0D;&#x53EF;&#x7528;&#xFF0C;&#x5219; Moment &#x5C06;&#x4F1A; <code>console.warn</code>&#x3002;</p>
<p>&#x4ECE; <strong>2.8.0</strong> &#x5F00;&#x59CB;&#xFF0C;&#x66F4;&#x6539;&#x5168;&#x5C40;&#x7684;&#x8BED;&#x8A00;&#x73AF;&#x5883;&#x4E0D;&#x4F1A;&#x5F71;&#x54CD;&#x5DF2;&#x5B58;&#x5728;&#x7684;&#x5B9E;&#x4F8B;&#x3002;</p>
<pre><code class="language-javascript">moment.locale(&apos;fr&apos;);
var m = moment(1316116057189);
m.fromNow(); // il y a une heure

moment.locale(&apos;en&apos;);
m.fromNow(); // il y a une heure
moment(1316116057189).fromNow(); // an hour ago
</code></pre>
<p><code>moment.locale</code> &#x8FD4;&#x56DE;&#x4F7F;&#x7528;&#x7684;&#x8BED;&#x8A00;&#x73AF;&#x5883;&#x3002;
&#x8FD9;&#x5F88;&#x6709;&#x7528;&#xFF0C;&#x56E0;&#x4E3A;&#x5982;&#x679C; Moment &#x4E0D;&#x77E5;&#x9053;&#x4F60;&#x6307;&#x5B9A;&#x7684;&#x8BED;&#x8A00;&#x73AF;&#x5883;&#xFF0C;&#x5B83;&#x5C31;&#x4E0D;&#x4F1A;&#x66F4;&#x6539;&#x8BED;&#x8A00;&#x73AF;&#x5883;&#x3002;</p>
<pre><code class="language-javascript">moment.locale(&apos;fr&apos;); // &apos;fr&apos;
moment.locale(&apos;tq&apos;); // &apos;fr&apos;
</code></pre>
<p>&#x4E5F;&#x53EF;&#x4EE5;&#x6307;&#x5B9A;&#x4E00;&#x4E2A;&#x8BED;&#x8A00;&#x73AF;&#x5883;&#x7684;&#x5217;&#x8868;&#xFF0C;Moment &#x5C06;&#x4F1A;&#x4F7F;&#x7528;&#x5B83;&#x5177;&#x6709;&#x672C;&#x5730;&#x5316;&#x7684;&#x7B2C;&#x4E00;&#x4E2A;&#x8BED;&#x8A00;&#x73AF;&#x5883;&#x3002;</p>
<pre><code class="language-javascript">moment.locale([&apos;tq&apos;, &apos;fr&apos;]); // &apos;fr&apos;
</code></pre>
<p>Moment &#x8FD8;&#x5C06;&#x4F1A;&#x5C1D;&#x8BD5;&#x4ECE;&#x6700;&#x7279;&#x5B9A;&#x5230;&#x6700;&#x4E0D;&#x7279;&#x5B9A;&#x7684;&#x8BED;&#x8A00;&#x73AF;&#x5883;&#x8BF4;&#x660E;&#x7B26;&#x5B50;&#x5B57;&#x7B26;&#x4E32;&#xFF0C;&#x76F4;&#x5230;&#x627E;&#x5230;&#x5B83;&#x77E5;&#x9053;&#x7684;&#x8BED;&#x8A00;&#x73AF;&#x5883;&#x3002;
&#x5F53;&#x4E3A; Moment &#x63D0;&#x4F9B;&#x4ECE;&#x7528;&#x6237;&#x73AF;&#x5883;&#x4E2D;&#x62C9;&#x51FA;&#x7684;&#x8BED;&#x8A00;&#x73AF;&#x5883;&#x5B57;&#x7B26;&#x4E32;&#xFF08;&#x4F8B;&#x5982; <code>window.navigator.language</code>&#xFF09;&#x65F6;&#xFF0C;&#x8FD9;&#x5F88;&#x6709;&#x7528;&#x3002;</p>
<pre><code class="language-javascript">moment.locale(&apos;en-NZ&apos;); // &apos;en&apos;
</code></pre>
<p>&#x6700;&#x540E;&#xFF0C;Moment &#x5C06;&#x4F1A;&#x901A;&#x8FC7;&#x4E00;&#x7CFB;&#x5217;&#x8BED;&#x8A00;&#x73AF;&#x5883;&#x53CA;&#x5176;&#x5B50;&#x5B57;&#x7B26;&#x4E32;&#x8FDB;&#x884C;&#x667A;&#x80FD;&#x641C;&#x7D22;&#x3002;</p>
<pre><code class="language-javascript">moment.locale([&apos;en-NZ&apos;, &apos;en-AU&apos;]); // &apos;en-au&apos;, &#x800C;&#x4E0D;&#x662F; &apos;en&apos;
</code></pre>
					</div>
          <div id="content_right">
							<div class="docs-method-signature">
								<pre><code class="language-js">// From 2.8.1 onward
moment.locale(String);
moment.locale(String[]);
moment.locale(String, Object);

// Deprecated in 2.8.1
moment.lang(String);
moment.lang(String[]);
moment.lang(String, Object);
</code></pre>

							</div>
<p>By default, Moment.js comes with English (United States) locale strings. If you need other locales, you can load them into Moment.js for later use.</p>
<p>To load a locale, pass the key and the string values to <code>moment.locale</code>.</p>
<p>More details on each of the parts of the locale bundle can be found in the <a href="#/customization/" target="_blank" rel="nofollow">customization</a> section.</p>
<pre><code class="language-javascript">moment.locale(&apos;fr&apos;, {
    months : &apos;janvier_f&#xE9;vrier_mars_avril_mai_juin_juillet_ao&#xFB;t_septembre_octobre_novembre_d&#xE9;cembre&apos;.split(&apos;_&apos;),
    monthsShort : &apos;janv._f&#xE9;vr._mars_avr._mai_juin_juil._ao&#xFB;t_sept._oct._nov._d&#xE9;c.&apos;.split(&apos;_&apos;),
    monthsParseExact : true,
    weekdays : &apos;dimanche_lundi_mardi_mercredi_jeudi_vendredi_samedi&apos;.split(&apos;_&apos;),
    weekdaysShort : &apos;dim._lun._mar._mer._jeu._ven._sam.&apos;.split(&apos;_&apos;),
    weekdaysMin : &apos;Di_Lu_Ma_Me_Je_Ve_Sa&apos;.split(&apos;_&apos;),
    weekdaysParseExact : true,
    longDateFormat : {
        LT : &apos;HH:mm&apos;,
        LTS : &apos;HH:mm:ss&apos;,
        L : &apos;DD/MM/YYYY&apos;,
        LL : &apos;D MMMM YYYY&apos;,
        LLL : &apos;D MMMM YYYY HH:mm&apos;,
        LLLL : &apos;dddd D MMMM YYYY HH:mm&apos;
    },
    calendar : {
        sameDay : &apos;[Aujourd&#x2019;hui &#xE0;] LT&apos;,
        nextDay : &apos;[Demain &#xE0;] LT&apos;,
        nextWeek : &apos;dddd [&#xE0;] LT&apos;,
        lastDay : &apos;[Hier &#xE0;] LT&apos;,
        lastWeek : &apos;dddd [dernier &#xE0;] LT&apos;,
        sameElse : &apos;L&apos;
    },
    relativeTime : {
        future : &apos;dans %s&apos;,
        past : &apos;il y a %s&apos;,
        s : &apos;quelques secondes&apos;,
        m : &apos;une minute&apos;,
        mm : &apos;%d minutes&apos;,
        h : &apos;une heure&apos;,
        hh : &apos;%d heures&apos;,
        d : &apos;un jour&apos;,
        dd : &apos;%d jours&apos;,
        M : &apos;un mois&apos;,
        MM : &apos;%d mois&apos;,
        y : &apos;un an&apos;,
        yy : &apos;%d ans&apos;
    },
    dayOfMonthOrdinalParse : /\d{1,2}(er|e)/,
    ordinal : function (number) {
        return number + (number === 1 ? &apos;er&apos; : &apos;e&apos;);
    },
    meridiemParse : /PD|MD/,
    isPM : function (input) {
        return input.charAt(0) === &apos;M&apos;;
    },
    // In case the meridiem units are not separated around 12, then implement
    // this function (look at locale/id.js for an example).
    // meridiemHour : function (hour, meridiem) {
    //     return /* 0-23 hour, given meridiem token and hour 1-12 */ ;
    // },
    meridiem : function (hours, minutes, isLower) {
        return hours &lt; 12 ? &apos;PD&apos; : &apos;MD&apos;;
    },
    week : {
        dow : 1, // Monday is the first day of the week.
        doy : 4  // Used to determine first week of the year.
    }
});
</code></pre>
<p>Details about <code>week.dow</code> and <code>week.doy</code> can be found in the <a href="#/customization/dow-doy/" target="_blank" rel="nofollow">customization</a> section.</p>
<p>Once you load a locale, it becomes the active locale. To change active locales, simply call <code>moment.locale</code> with the key of a loaded locale.</p>
<pre><code class="language-javascript">moment.locale(&apos;fr&apos;);
moment(1316116057189).fromNow(); // il y a une heure
moment.locale(&apos;en&apos;);
moment(1316116057189).fromNow(); // an hour ago
</code></pre>
<p>As of <strong>2.21.0</strong>, Moment will <code>console.warn</code> if the locale is unavailable.</p>
<p>As of <strong>2.8.0</strong>, changing the global locale doesn&apos;t affect existing instances.</p>
<pre><code class="language-javascript">moment.locale(&apos;fr&apos;);
var m = moment(1316116057189);
m.fromNow(); // il y a une heure

moment.locale(&apos;en&apos;);
m.fromNow(); // il y a une heure
moment(1316116057189).fromNow(); // an hour ago
</code></pre>
<p><code>moment.locale</code> returns the locale used. This is useful because Moment won&apos;t change locales if it doesn&apos;t know the one you specify.</p>
<pre><code class="language-javascript">moment.locale(&apos;fr&apos;); // &apos;fr&apos;
moment.locale(&apos;tq&apos;); // &apos;fr&apos;
</code></pre>
<p>You may also specify a list of locales, and Moment will use the first one it has localizations for.</p>
<pre><code class="language-javascript">moment.locale([&apos;tq&apos;, &apos;fr&apos;]); // &apos;fr&apos;
</code></pre>
<p>Moment will also try locale specifier substrings from most-specific to least-specific until it finds a locale it knows. This is useful when supplying Moment with a locale string pulled from the user&apos;s environment, such as <code>window.navigator.language</code>.</p>
<pre><code class="language-javascript">moment.locale(&apos;en-NZ&apos;); // &apos;en&apos;
</code></pre>
<p>Finally, Moment will search intelligently through an array of locales and their substrings.</p>
<pre><code class="language-javascript">moment.locale([&apos;en-NZ&apos;, &apos;en-AU&apos;]); // &apos;en-au&apos;, not &apos;en&apos;
</code></pre>
					</div>
          <div></div>
        </div>
      </div>
    </div>
  </div>
  
  <script src="static/js/highlight.min.js"></script>
  <script src="static/js/javascript.min.js"></script>
  <script>hljs.initHighlightingOnLoad();</script>
  <script>var _hmt = _hmt || []; (function () { var hm = document.createElement("script"); hm.src = "//hm.baidu.com/hm.js?7a7f78c805fbacc7e075d34f153031aa"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })();</script>

  <style>
    .hero-centered {
      margin: 0;
          margin-left: 10px;
    }
#gtoc ul {
  list-style: none;
  margin-left: 0;
  line-height: 1.5rem;
  padding: 0;
}
#gtoc>ul>li {
  display: inline;
  border-right: 1px solid #000;
  margin-right: .4rem;
  padding-right: .4rem;
}
#gtoc>ul>li>a {
  color: #61b2a7;
}
#content_left {
  width: 49%;float: left;border-right: 1px solid #eee;    padding-right: 2%;
}
#content_right {
float: left;width: 48%;margin-left: 3%;
}
#column1 {
  padding: 0 2rem;
}
  </style>


</body></html>